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SUMMARY 


Release 12 of the Cromemco Z80 Macro Assembler is now 
available. It includes updated versions of the Assembler, 
Debugger, Linker, Assembler library, and CDOS device drivers. 


ASM (version 03.10, previous version 03.08) 


The Exitm pseudo-op has been fixed. . The previous version of 
the Assembler would not deallocate the temporary storage 
allocated during expansion of the macro when it encountered 
an Exitm inside a Repeat, Irp, or Irpe block. This sometimes 


_ caused the Assembler to run out of memory while assembling 
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very long programs. 


ASMLIB.MAC (new file) 


This file contains macros that simplify the process of 
calling functions from the library asmlib.rel. Previously, 
the programmer had to push all parameters onto the stack, 
call the function, and then pop the parameters back off the 
stack. These macros handle the stack manipulation associated 
with the parameters, allowing the programmer to call the 
function similar to how he or she would do so from a 
high-level language. 
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The first macro in the file, defext, lists the functions for 
which macros are provided. The use of each macro, along with 
an example, is included in the comments preceding the text of 
the macro. When using these macros, be sure to include the 
asmlib.mac file by entering: 


#MACLIB asmlib.mac 


at the beginning of your program. 


DEBUG (version 00.20, previous version 00.17) 
Command parameter handling while running Debug under the 
Cromix Operating System has now been implemented. A .bin or 


-com program can now be debugged without problems if it has 
command line parameters as in the following example: 


debug program parameter-1 parameter-—2 ... 


Previous versions of Debug required the user. to use the SM 
command to manually load the command line: into memory after 
invoking. debug. 


When running Debug under CDOS, parameter handling must be 
done differently. First type: 

debug program 
Then, after Debug has responded with a prompt, type: 


f parameter-1 parameter-2 


This has the effect of setting up a properly formed command 
line starting at 80h, where CDOS programs expect it to be. 


Programs written in C were difficult to debug using Debug 


version 00.17. The reason is that C function calls are 
effectively four bytes long: the usual call instruction 
followed by the number of bytes pushed onto the system stack 
as parameters, The C function itself modifies the stack 
pointer when execution begins, thereby causing illegal 
execution of the debugger C, CJ, CN, and CNJ commands. Also, 
the L command usually produced garbage when listing calls to 
C functions. 
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Debug version 00.20 is aware of the structure of C functions, 
and it recognizes the calls to such functions, The result is 
that all Debug commands work on a C program. However, for 
Debug to recognize such calls only when they are calis to C 
functions, the Debugger must know the address of the 
parameter handling subroutine ($FENTER). There is a new 
register in the Debugger named $FENTER. To debug C programs, 
this register must be set to the actual $FENTER address 
(found in the Linker maps). The $FENTER register is 
displayed and set with the X command in the same way as the 
AT register is set and displayed with the @ command. 


When Debug finds a call to a C function, it lists the call 
instruction as a new (four-byte-long) instruction in the form 


CALL ADDRESS, COUNT 
with the actual meaning 


CALL ADDRESS 

DEFB COUNT 
Note that the pudbt—in Assembler also recognizes such calls. 
pebue now ignores the value of the parity bit during the 


Output to Data Port command. It is possible to output 16 
bits at once, 


ASMLIB 


The routine Printf has been added: to the Assembler library. 


‘It accepts argument values, argument. aOOr Seacee and a control 


String to generate formatted output. 


Printf writes formatted output, based on a control string and 
zero or more parameters. The control string consists of 
literal characters to be printed, as well as a specification 
of where, and in what form, the parameters are to be inserted 
among the.literal characters. Parameters are substituted at 
locations where a percent sign, followed by a conversion 
specification, appears in the control string. The percent 
Sign denotes the’ location of substitution, while the 
conversion specification determines how the parameter will be 
interpreted and substituted. In order to output a single 
percent sign, a pair of percent signs must be listed in the 
control string. 
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The conversion specification has the following format: 


4t,ie 


Arguments: 
4 
Z 


Options: 


XXX. YYY 


-J(XXX.YYYJ([L]Z 


Specifies where the substitution will be made. 


Determines how the parameter will be interpreted 
and substituted. Z may be any of the following: 


D Converts the argument to a decimal number. 

U Converts the argument to an unsigned decimal 
number. 

x Converts the argument to an unsigned 


hexadecimal number. 


C Specifies the argument as a Single character. 
When the argument is pushed onto the stack, 
the character must be in the low-order byte of 
the register pair that is pushed. 


Ss Specifies the argument as a character string. 
A pointer to this string must be pushed onto 
the stack in place of the string itself. 


L Specifies the argument as a 32-bit integer. 


A comma after % specifies that commas will appear 
in the output (as in 1,000,000). 


If a minus sign follows %, the argument will be 
left-justified. Otherwise, it will be 
right-justified. 


Two numbers, separated by a period. The first 
numbér is the minimum field width -- if XXX is not 
specified, this value is assumed to be 0. The 
second number is the maximum field width -- if YYY 
is not specified, this value is undefined (large). 


Specifies the argument as a long (32-bit) number. 
0 ea the argument is assumed to be short (16 
bits 
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ak In addition, '\r', '\n', '"\O', \l, \f, \b, \t may be used 
within strings to specify the RETURN, newline, null, line 
feed, form feed, backspace, and TAB characters, respectively. 


The calling sequence for Printf consists of first pushing any 
parameters onto the stack, loading the HL register with the 
address of the control string, executing the CALL PRINTF 
instruction, and then popping the parameters off the stack. 
For example: ; 


EXTRN PRINTF 


CSTRING: DB 'ZsZ%Zc are 4d cents each.\n\r\0! 
SSTRING: DB "Apple\0! 
PRICE: EQU 10 
MAIN: LD. HL, PRICE -\ 
PUSH HL > \ 
LD HL, ‘*s* a) oN 
PUSH HL : stack parameters 
LD HL, SSTRING 50 oo 
PUSH HL ord 
LD HL, CSTRING- j; pointer to the control string 
CALL PRINTF 
— POP HL :\ 
ear POP HL * pop parameters 
POP HL ;/ 
JP 0 : 


return to operating system 
END MAIN . 


Would print the string: Apples are 10 cents each. 


Three things should be noted from this example. First, the 
‘parameters are pushed onto the stack in- reverse order from |. 
that used by the control string. That is, the parameter for 
the first percent sign is actually the last parameter to be 
pushed onto the stack, Second, all strings must be 
terminated with a null character. Third, strings are passed 

to Printf by pushing their addresses onto the stack. 


An easier way to call Printf is to use the Printf macro 
provided in the file asmlib.mac. This macro frees the user 
from the task of pushing and popping each argument. Instead, 
it allows Printf to be called as it would be from a 
high-level language. The. following program demonstrates the 
use of this macro: 


’ 


Cromemco Software Update Service Note 
Z80 Macro Assembler-2 Release 12 


( 


*®MACLIB asmlib.mac 


EXTERN PRINTF 


CSTRING: DB '?s%ce are %Zd cents each.\n\r\0'! 
SSTRING: DB "Apple\O' 
PRICE: EQU 10 
MAIN: PRINTF CSTRING, SSTRING, 's', PRICE. 
JP _ 0 : 
END MAIN 


Like the preceding example, this program prints the string: 
Apples are 10 cents each. 


Note that the MACLIB pseudo operation is necessary for the 


Assembler to look in the asmlib.mac file for the Printf 
macro.. 


CDOS DEVICE DRIVERS 
The file drivers.z80 contains the CRT and printer device 
drivers used in CDOS version 02.56. The user can modify and 


assemble this file in order to generate a epee system 
customized for specific peripherals. 


VERSION NUMBER SUMMARY 


asmb.com 03.10 


_asmlib.mac 


asmlib.rel 
debug.com 00.20 
drivers.cmd 
drivers.doc 
drivers.z80 for CDOS 02.56 
example.cmd 
example.z80 

fda.doc 

install.ecrx 

lib.com 

link.com 03.44 
translat.com 02.40 
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